home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / boot / DontCloseWB.lha / DontCloseWB / DontCloseWB.doc < prev    next >
Text File  |  1995-06-18  |  4KB  |  108 lines

  1.  
  2.                                 DontCloseWB V1.0
  3.  
  4.  
  5.  
  6.      Function:
  7.  
  8.      This is a patch that disables  programs  from  closing  the  Workbench
  9.      Screen.
  10.  
  11.  
  12.  
  13.      Background:
  14.  
  15.      Since the times of Kickstart 1.x programs may call  a  function  named
  16.      CloseWorkBench  that closes the WB screen, so the program can get some
  17.      more memory. Under Kickstart  2.0  and  higher  the  handling  of  the
  18.      Workbench  Screen  has  somewhat  changed.  As a Public Screen, the WB
  19.      screen normally should not be closed.  Nevertheless  there  are  still
  20.      applications  that  try to close it. If there is an open shell or some
  21.      other window that does not belong to the WB nothing will  happen.  But
  22.      since  I  cannot  be  sure of always having an open shell window on my
  23.      Workbench Screen I  wrote  this  little  patch  that  will  not  allow
  24.      programs to close the WB screen.
  25.  
  26.  
  27.  
  28.      IPrefs:
  29.  
  30.      IPrefs is responsible of applying the changes in  the  preferences  to
  31.      the  system.  Under  Workbench  3.0  and  3.1  IPrefs  can be found as
  32.      "« IPrefs »" in the task list. Under Workbench 2.04  IPrefs'  name  is
  33.      "IPrefs 37.xxx  (xx.xx.xx)"  (this  seems  to  be the version string).
  34.      Since I do not have access to an Amiga with Workbench 2.05 or 2.1 I do
  35.      not know IPrefs' name under these versions.
  36.  
  37.      DontCloseWB can detect if IPrefs 3.0 or 3.1  tries  to  close  the  WB
  38.      screen.  If  future  versions of IPrefs will be called "« IPrefs »" in
  39.      the task list they will also be detected, of course. However,  if  one
  40.      of  these  IPrefs  versions  tries  to  close the WB screen it will be
  41.      allowed to do so. This means that there will be no problems  when  you
  42.      want to change the WB screen mode.
  43.  
  44.      If Kickstart 2.04 users try to change the screen mode of their WB they
  45.      will  see  a  confusing  requester  after  the  have  clicked  on  the
  46.      "Use"-Gadget in the Prefs. They have to disable DontCloseWB  with  the
  47.      Commodities  exchange  program, click on "Retry" and finally re-enable
  48.      DontCloseWB. Sorry for this little inconvenience. If You want this  to
  49.      be changed feel free to write an Email or a letter to me.
  50.  
  51.  
  52.  
  53.      Usage:
  54.  
  55.      Simply start DontCloseWB by typing "DontCloseWB" in  a  shell  window.
  56.      Putting  DontCloseWB  into Your User-Startup is highly recommended ;-)
  57.      Since DontCloseWB will not detach from the current shell,  You  should
  58.      of course write "Run >NIL: DontCloseWB" to Your User-Startup.
  59.  
  60.      When DontCloseWB is running  You  can  use  the  Commodities  exchange
  61.      program  to  enable,  disable  or  quit DontCloseWB. You can also quit
  62.      DontCloseWB by sending it a CTRL_C signal or by running  it  a  second
  63.      time.
  64.  
  65.      As You can easily imagine, DontCloseWB will not  work  with  Kickstart
  66.      versions less than 2.04.
  67.  
  68.  
  69.  
  70.      Technical:
  71.  
  72.      Yes, this is a hack. A patch that disables the CloseWorkBench entry of
  73.      the Intuition-Library by simply ReTurning from Subroutine (RTS) unless
  74.      the name of the actual task is "« IPrefs »".
  75.  
  76.      Removing  the  patch  is  fairly  safe:  When  You  disable  or   quit
  77.      DontCloseWB  it  will  check whether the CloseWorkBench entry has been
  78.      overpatched  in  the  meantime.  If  not,  DontCloseWB  can  set   the
  79.      CloseWorkBench  entry  to  its  previous  value, but otherwise it will
  80.      remove itself from a "buffer area", not from the CloseWorkBench entry.
  81.  
  82.  
  83.  
  84.      Address:
  85.  
  86.      Send everything (bug reports, comments, etc...) concerning DontCloseWB
  87.      to:
  88.  
  89.      Roland Fulde                              Email: fulde@Uni-Muenster.De
  90.      Kiebitzweg 12
  91.      48329 Havixbeck
  92.      Germany
  93.  
  94.  
  95.  
  96.      Copyright:
  97.  
  98.      DontCloseWB is Freeware: You may use it, You may copy it, but You must
  99.      not  sell it for more than 100$ ;-) Of couse, You must not change this
  100.      documentation, either...
  101.  
  102.  
  103.  
  104.      History:
  105.  
  106.      V1.0 (18.06.95)  First release.
  107.  
  108.